home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / xt.arc / XT.DOC next >
Text File  |  1986-09-08  |  5KB  |  121 lines
  1.                             xt - eXecute over Tree
  2.                                   Version 1.0
  3.                                  Chris Dunford
  4.  
  5.         Use
  6.         ---
  7.         XT is a simple program that repeatedly executes commands over an
  8.         entire directory tree, or over any specified subtree.  Usage is:
  9.  
  10.             xt [d:]path command [args]
  11.  
  12.         For example:
  13.  
  14.             xt \db dir *.*
  15.  
  16.         "XT", of course, runs the XT program.  The "\db" tells XT to
  17.         start its directory search at directory "\db" of the current
  18.         drive.  The "dir *.*" is just a normal "dir *.*".  XT will
  19.         descend through the directory tree beginning at directory \DB,
  20.         and issue a "dir *.*" command for each subdirectory found.
  21.  
  22.         If the directory tree were as follows:
  23.  
  24.             \--+---dir1
  25.                |
  26.                +---db
  27.                |   +--dbprgs
  28.                |   +--dbdata
  29.                |
  30.                +---dir2
  31.  
  32.         then XT would issue the following commands:
  33.  
  34.             cd \db\dbprgs
  35.             dir *.*
  36.             cd \db\dbdata
  37.             dir *.*
  38.             cd \db
  39.             dir *.*
  40.             cd <the current dir at the time xt was executed>
  41.  
  42.         If you wish to execute a command over an entire disk, use the
  43.         "\" root directory:
  44.  
  45.             xt c:\ dir
  46.  
  47.         would display a list of all files on the disk (by issuing a DIR
  48.         command in each subdirectory).
  49.  
  50.  
  51.         Notes
  52.         -----
  53.         1. You can use DOS's "." and ".." terminology to refer to the
  54.         current directory and the current parent, respectively:
  55.  
  56.             xt . command        (start search in current dir)
  57.             xt .. command       (start search in current dir's parent)
  58.  
  59.         2. XT works by changing directories repeatedly. If you cancel XT
  60.         before it is finished (via Ctrl-Break), you may find that your
  61.         current directory has changed.
  62.  
  63.         3. XT will use a secondary copy of the command processor
  64.         (COMMAND.COM or the current COMSPEC) if the command meets
  65.         any of these criteria:
  66.  
  67.             a. It is an internal DOS command.
  68.             b. It contains piping or redirection.
  69.             c. It is a batch file.
  70.             d. The command contains ANY explicit extension.
  71.             e. XT cannot find the program as a COM or EXE file in
  72.                the current directory or anywhere in the PATH.
  73.  
  74.         If none of the above are true, XT will execute the command
  75.         directly, i.e., without reloading the command processor.
  76.  
  77.  
  78.         Revision history
  79.         ----------------
  80.         Version 1.00 - 9/8/86
  81.             Original version
  82.  
  83.  
  84.         Copyright/License/Warranty
  85.         --------------------------
  86.         This document and the current version of the program file XT.EXE
  87.         ("the software") are copyrighted by the author.  The copyright
  88.         owner hereby licenses you to: use the software; make as many
  89.         copies of the program and documentation as you wish; give such
  90.         copies to anyone; and distribute the software and documentation
  91.         via electronic means.  There is no charge for any of the above.
  92.  
  93.         However, you are specifically prohibited from charging, or
  94.         requesting donations, for any such copies, however made; and
  95.         from distributing the software and/or documentation with
  96.         commercial products without prior permission.  An exception is
  97.         granted to not-for-profit user's groups, which are authorized to
  98.         charge a small fee (not to exceed $7) for materials, handling,
  99.         postage, and general overhead.  NO FOR-PROFIT ORGANIZATION IS
  100.         AUTHORIZED TO CHARGE ANY AMOUNT FOR DISTRIBUTION OF COPIES OF
  101.         THE SOFTWARE OR DOCUMENTATION, OR TO INCLUDE COPIES OF THE
  102.         SOFTWARE OR DOCUMENTATION WITH SALES OF THEIR OWN PRODUCTS.
  103.  
  104.         There is no restriction on the use of this software in
  105.         commercial or institutional environments.
  106.  
  107.         No copy of the software may be distributed or given away without
  108.         this document; and this notice must not be removed.
  109.  
  110.         There is no warranty of any kind, and the copyright owner is not
  111.         liable for damages of any kind.  By using this free software,
  112.         you agree to this.
  113.  
  114.         The software and documentation are:
  115.  
  116.                              Copyright (c) 1986 by
  117.                             Christopher J. Dunford
  118.                            10057-2 Windstream Drive
  119.                            Columbia, Maryland 21044
  120.                                 (301) 992-9371
  121.